Summary

This commit enhances @rushstack/rush-sdk to support named imports when the package is consumed via ESM project.

Resolve #5506

Details

Here's the changes.

libraries/rush-sdk/package.json

• Added [email protected] as devDependency. Required for extracting named exports during stub generation. Version 2.1.0 is consistent with the built-in version in Node.js.

libraries/rush-sdk/config/jest.config.json

• Changed test roots and testMatch from "lib-shim" to "lib-commonjs" directory to fix tests.

libraries/rush-sdk/src/generate-stubs.ts

• Implemented extractNamedExports(source) function to parse CommonJS modules and extract export names.
• Generated stubs now include named export placeholders (e.g., "exports.foo = exports.bar = undefined").
• This allows proper named import/destructuring when consuming the package.

libraries/rush-sdk/src/test/snapshots/script.test.ts.snap

• Updated snapshot to include '_OperationBuildCache' in exported API surface.
• Removed "install-run" test case snapshot because the stdout now includes local account info which should not be recorded in snapshot. (test remains but assertion changed).

libraries/rush-sdk/src/test/script.test.ts

• Changed "install-run" test assertion from full snapshot match to partial string match.

libraries/rush-sdk/src/test/build-assets-with-named-exports.test.ts (NEW)

• Added new test to verify named exports work correctly with ESM imports. Both for lib-shim/ and lib/ assets.

libraries/rush-sdk/webpack.config.js

• Added webpack.BannerPlugin import from webpack. Reads all export specifiers from @microsoft/rush-lib and inject the dynamic exports placeholder code by using ths BannerPlugin.

The core improvement enables consumers to use both default imports and named destructuring:

// Both styles now work correctly:
const rushSdk = await import('@rushstack/rush-sdk');
rushSdk.RushConfiguration.loadFromConfigurationFile();

const { RushConfiguration } = await import('@rushstack/rush-sdk');
RushConfiguration.loadFromConfigurationFile();

const { default: rushSdk } = await import('@rushstack/rush-sdk');
rushSdk.RushConfiguration.loadFromConfigurationFile();

How it was tested

Unit tests were added.

Impacted documentation

None